home *** CD-ROM | disk | FTP | other *** search
/ 3D GFX / 3D GFX.iso / amiutils / e_h / fractgenerator / frac.doc < prev    next >
Text File  |  1995-12-30  |  7KB  |  240 lines
  1.                IFS Fractal Generator Version 1.0 (Frac)
  2.                ========================================
  3.                  
  4.                  
  5. This program and documentation is (C) Copyright Trefor Southwell 1995.
  6.  
  7. Frac  is shareware and may be freely distributed provided you do not charge
  8. any money for it.
  9.  
  10. If you like this program or would like to suggest any improvements then
  11. please contact me:-
  12.  
  13.     email:    trefor@flevel.demon.co.uk
  14.  
  15.     Snail:    Trefor Southwell
  16.         31, Ashley Hill
  17.         Montpelier
  18.         Bristol
  19.         BS6 5JA
  20.  
  21.  
  22.             About Frac
  23.             ==========
  24.  
  25. Frac  allows  the  user  to design and view IFS (Iterated Function Systems)
  26. fractals on their Amiga.
  27.  
  28. Currently  only  affine transformations are supported.  The transformations
  29. can be entered in either scale/angle or matrix format.
  30.  
  31. Frac  is  not  designed  to  just display pretty pictures, it is really for
  32. people who are interested in fractals.
  33.  
  34. Frac  was  written  using Dice C V3.01 Commercial.  The GUI was designed on
  35. gadtoolsbox.
  36.  
  37. Sorry the manual is not very good, I haven't had time to improve it much.
  38.  
  39.  
  40.             Using Frac
  41.             ==========
  42.             
  43.             
  44. 1. Installation
  45. ===============
  46.  
  47. Just extract the archive in a suitable directory and then run frac.
  48.  
  49. 2. The basics
  50. =============
  51.  
  52. a. Generating an IFS.
  53. ---------------------
  54.  
  55. By  clicking  on  the  GO button frac will start to generate the IFS in the
  56. display  window.   If  you  want  to stop it at any time, click on the STOP
  57. button.
  58.  
  59. The IFS can be gererated in 3 ways:
  60.  
  61.     1) Recursive
  62.  
  63.         The IFS is generated by recursivley plotting dots.
  64.         You can set the number of iterations by changing
  65.         the ITERS value on the control panel.
  66.  
  67.     2) Random
  68.  
  69.         The IFS is build up randomly out of dots. This is the
  70.         fastest method of drawing and gives you a basic image
  71.         very quickly. The random method keeps drawing until you
  72.         click the stop button.
  73.  
  74.     3) Bitmap
  75.  
  76.         The IFS is build up by iterations performed on the
  77.         contents of the window as a bitmap. This is very slow
  78.         but allow you to see how the IFS is working.
  79.  
  80. You  can  change  the  drawing method by clicking on the button next to the
  81. method you require.
  82.  
  83. If  you  want your image to be updated every time you change something then
  84. enable the autodraw checkbox.
  85.  
  86.  
  87. b. Zooming and panning
  88. ----------------------
  89.  
  90. To  re-centre  the  display  about a chosen point just click on the display
  91. where you want the new centre to be.
  92.  
  93. To zoom in by a factor of 1.5 click on the ZIN button.
  94.  
  95. To zoom out by a factor of 1.5 click on the ZOUT button.
  96.  
  97. If  you  have  autodraw  on  then the IFS will be re-displayed immediatley,
  98. otherwise  you will see a dotted box which shows the selected zoom, you can
  99. then click GO to redraw.
  100.  
  101. If  you  have  got  lost zooming around then generate the fractal in either
  102. random  or recursive mode and then click on the AUTO button.  This will set
  103. the range to view the whole fractal again.
  104.  
  105. c. Loading and saving
  106. ---------------------
  107.  
  108. A number of examples have been included with frac.
  109.  
  110. To  load a set of IFS codes into frac click on the load button.  Select the
  111. file you wish to load.
  112.  
  113. To save a set of IFS codes click on the save button and select the filename
  114. you wish to save the codes as.
  115.  
  116. All  you  settings for frac are stored with the IFS codes.  If you save the
  117. codes  with  autodraw  on then when they are loaded frac will start drawing
  118. immediatley.
  119.  
  120. d. Coordinates
  121. --------------
  122.  
  123. If  you  click  on  the  COORD box then you can view and change the current
  124. window coordinates.
  125.  
  126. 3. Editing IFS's
  127. ================
  128.  
  129. Click on the IFS button to bring up the editing window.  You can now select
  130. the affine transformation you wish to edit with the TRANS slider bar.
  131.  
  132. a. Entering values
  133. ------------------
  134.  
  135. You can type values into the matrix as decimals or fractions e.g.
  136.  
  137.     0.333333
  138.  
  139.     or
  140.  
  141.     1/3
  142.  
  143. You can change the mode between degrees (DEGS) or radians (RADS).
  144.  
  145. You can change between scale/angle (ANGLE) and matrix format (MATRIX).
  146.  
  147. Warning: When you change the mode your numbers will NOT be converted.
  148.  
  149.  
  150. Scale/Angle Mode
  151. -----------------
  152.  
  153. The  ANGLEX  and  ANGLEY fields are used to set the amount of rotation that
  154. the  transformation performs.  Setting ANGLEX and ANGLEY to the same amount
  155. makes the rotation circular.
  156.  
  157. The  SCALEX  and  SCALEY  fields  are  used  to  set  the amount of scaling
  158. performed in the X and Y axis.
  159.  
  160. Matrix Mode
  161. -----------
  162.  
  163. The  values  you  enter  form  a 2x2 matrix which is then multiplied by the
  164. coordinates.  The matrix is:
  165.  
  166.     [ ScaleX         |   ScaleX(Y) ]
  167.     [ ScaleY(X)   |     ScaleY     ]
  168.  
  169.  
  170. Common Fields
  171. -------------
  172.  
  173. The  MOVEX  and  MOVEY  fields  are  used  to  give  the  transformation  a
  174. translation (movement) in the X and Y axis.
  175.  
  176. The  WEIGHT  field  is used in random mode to set the probability that each
  177. transformation is selected.  If all transformations have a weight of 1 then
  178. their probabilities are equal.
  179.  
  180. b. Adding/Deleting Transformations
  181. ----------------------------------
  182.  
  183. You  can add a new transformation at the end of the list by clicking on the
  184. NEW button
  185.  
  186. You can delete the current transformation by clicking on the DELETE button.
  187. You can't delete a transformation if you only have 1 left.
  188.  
  189. c. Previewing your IFS
  190. ----------------------
  191.  
  192. Drawing
  193. -------
  194.  
  195. You  can  preview  your  IFS  using the tools at the bottom left of the IFS
  196. Codes window.
  197.  
  198. If  you  click  on the View button then the preview is drawn in the display
  199. window.
  200.  
  201. If  you  turn  on  AUTODRAW  while  you are editing the IFS codes then your
  202. preview will be updated as you alter the values.
  203.  
  204. The  preview  is  generated  from a black square.  When a transformation is
  205. applied the new square is shown.  The top side of the square is a different
  206. color so you can tell which way up it is.
  207.  
  208. Negative axis
  209. -------------
  210.  
  211. The  NEG  checkbox  when  set  means  the  preview rectangle will cover the
  212. negative  part  of the axis.  Set this when your IFS code has some negative
  213. coordinates.
  214.  
  215. Drawing method
  216. --------------
  217.  
  218. The  SINGLE/ALL/TOGETHER selector is used to choose how the preview will be
  219. rendered.
  220.  
  221. When  SINGLE  is  selected only the current Transformation will be shown on
  222. the preview.
  223.  
  224. When  ALL  is  selected  all  Transformations will be shown on the preview.
  225. They will not however interact.
  226.  
  227. When TOGETHER is selected the transformations will be applied all together.
  228. This gives a preview of what the IFS will look like.
  229.  
  230. Iterations
  231. ----------
  232.  
  233. You  can  set the number of iterations in the preview by altering the Iters
  234. field.
  235.  
  236. If  you want to disable the interations then set the ONCE/ITERS selector to
  237. once.
  238.  
  239. ===========================================================================
  240.